Microsoft DirectX 8.1 (C++)

MediaDet.EnterBitmapGrabMode Method

The MediaDet.EnterBitmapGrabMode method switches the MediaDet object to bitmap grab mode and seeks the filter graph to a specified time.

Syntax

object.EnterBitmapGrabMode(
    SeekTime As Double
)

Parameters

SeekTime

Time, in seconds, to which the graph seeks.

Error Codes

If the method fails, an error is raised, and Err.Number can be set to one of the following values:

Value Description
E_INVALIDARG Invalid argument.
VFW_E_INVALIDMEDIATYPE File does not have a video stream.
VFW_E_TIME_EXPIRED Could not seek.

Remarks

Before calling this method, set the Filename and CurrentStream properties.

This method inserts the Sample Grabber filter into the filter graph. Once the MediaDet object enters bitmap grab mode, the various informational methods in MediaDet do not work.

The GetBitmapBits or WriteBitmapBits methods also put the object into bitmap grab mode.

See Also